home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / bat204a.arc / ERRATA < prev   
Encoding:
Text File  |  1985-07-27  |  12.3 KB  |  289 lines

  1.  
  2. ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡ E R R A T A ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡ (8/27/84)
  3.  
  4.     Program updates are made more often than the updates to the
  5. user's guide can keep up with.  In order to keep you better
  6. informed, this file contains information related to corrections
  7. or updates to the user's guide as well as notification of what
  8. problems were identified and fixed for the version of the program
  9. that is on this diskette.
  10.  
  11. Please refer to the users guide and the BATDOC.BAT file for
  12. information about Extended Batch Language commands and operation.
  13. For an example of the capabilities of 'EBL', execute the BATDEMO.BAT
  14. file by just typing "BATDEMO" at the DOS prompt.
  15.  
  16.  
  17.  
  18. USER'S GUIDE CORRECTIONS........
  19.  
  20. #1. Page 34 - 2nd paragraph.
  21.  
  22.     If the INKEY command senses a key pressed in the range of "!"
  23.   to "z" (decimal 33 to 122) then a key will be saved in the
  24.   optional variable as that single character.  It WILL NOT be
  25.   echoed to the display.  If you wish it to be displayed, you must
  26.   specifically use the TYPE command.
  27.  
  28.  
  29. #2. Page 46 - STATEOF command
  30.  
  31.  
  32.     STATEOF [filename] [drive.list]
  33.  
  34.   The [drive.list] option is new. This token is a list of
  35.   diskette drive letters which are to be searched for the
  36.   specified [filename]. For example, a [drive.list] of
  37.   ACD will search disk drives A:, C:, and D: in that order.
  38.   If a diskette is not in drive A:, DOS will request that
  39.   the user insert one and say "Abort, Retry, Ignore".
  40.  
  41.   That is, only the drive letters listed in [drive.list]
  42.   will be searched and ALL MUST BE INSERTED AND READY.
  43.  
  44.   If the [drive.list] option is not used, the old method
  45.   of searching drives A:, B:, C:, and D: will be used and
  46.   if a diskette is not inserted or ready, it will be
  47.   ignored. Do not omit this option if you are using the
  48.   STATEOF command with the DOS 'ASSIGN' statement or in a
  49.   network environment.
  50.  
  51.   All errors and return codes for the STATEOF command are
  52.   the same. Note that now the STATEOF command can also
  53.   search expanded drive lettering (E:, F:, etc...) by using
  54.   the [drive.list] option with these respective letters.
  55.  
  56.  
  57.  
  58. ====================================================================
  59. The following list of program corrections are for reference only. The
  60. fundamental operation of the program has not changed. Please refer to the
  61. manual for examples of how Extended Batch Language can be used.
  62. ====================================================================
  63.  
  64. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  65. PROGRAM CORRECTIONS/CHANGES (for version 2.00b of EBL)
  66. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  67.  
  68.     1.    TO REDUCE THE SIZE OF THE INITIAL LOGO:  If the special
  69. SIZE option is used when BAT is first invoked, it will also
  70. signal the initial logo screen to be reduced in size.  This
  71. initial logo screen is used to present the user supported
  72. concept.  In addition, it will not wait for a key-press to
  73. continue.  The SIZE option is created by making the first
  74. executed BAT statement:
  75.  
  76.     BAT * [decimal size] [comment]
  77.  
  78.     The [decimal size] is a number representing the amount of
  79. space to reserve for a keyboard stack area.  The default is 512
  80. bytes.    This is described further in section 4.1 on page 8 of the
  81. users guide.  For example use:
  82.  
  83.     BAT * 512 = stack size & reduces logo size.
  84.  
  85.     2.    The initial logo screen describing the user supported
  86. concept had a 'Press any key to continue...'.  If a key was
  87. pressed to advance past this screen, the key was sensed only and
  88. not actually read in.  Therefore, the key remained in the
  89. keyboard buffer and sometimes interfered with programs following
  90. BAT in an AUTOEXEC.BAT file.  If a key is pressed, it is actually
  91. removed from the keyboard buffer now.
  92.  
  93.     3.    The stack status variable %Q gave incorrect information
  94. as to the source of the next character.  Previously, information
  95. was said to come from the stack if the stack was not empty.  No
  96. attention was paid however to see if the stack was enabled
  97. (STACK.ON).  Now, information is said to come from the stack if
  98. both the stack is not empty and the stack is enabled.  This will
  99. now correctly represent the status of the SOURCE of the next
  100. keyboard character.
  101.  
  102.     4.    The READ function did not echo the keyboard characters to
  103. the screen if the stack was not empty and the STACK.OFF command
  104. was used.  This is no longer the case.    In all cases when the
  105. READ command reads characters from the keyboard, they will be
  106. echoed to the display.    Note that the echo will still be
  107. suppressed if characters are read from the keyboard stack
  108. instead.
  109.  
  110.  
  111.  
  112. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  113. PROGRAM CORRECTIONS/CHANGES (for version 2.01 of EBL)
  114. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  115.  
  116.  1.    Added code to speed up CALL/GOTO for large files.
  117.  
  118.  2.    Changed stack interface to BIOS to fix bug with multimate/filecmd.
  119.  
  120.  3.    Fixed CLS so won't erase background color with ANSI.SYS installed.
  121.  
  122.  4.    Made character I/O go to directly to BIOS (not DOS) to allow attributes
  123.            in spite of the way ANSI.SYS device driver traps and removes
  124.            prewritten screen attributes.
  125.  
  126.  5.    'Eagle' DOS 1.25 compatible now.
  127.  
  128.  6.    Pressing Ctrl-break will now make the stack pointer for CALL and RETURN
  129.            commands into an empty stack condition.
  130.  
  131.  7.    Added attributes to help messages.
  132.  
  133.  8.    Fixed bug in CALL commands immediately after a DOS command in order
  134.            to properly save the code location for a RETURN command.
  135.  
  136.  9.    When in TRACE.ON mode, the trace messages on a color display are
  137.            green. Messages from program are white. Users with a monochrome
  138.            monitor will not see any difference.
  139.  
  140. 10.    Message space has been optimized so that overall code size is smaller.
  141.  
  142. 11.    Fixed bug in stacking an F1 key by itself.
  143.  
  144. 12.    Protected stack further from invalid function key codes or time delay
  145.            codes.
  146.  
  147. 13.    When putting screen attributes within the text under a BEGTYPE
  148.            command, the use of ESC characters (used with ANSI.SYS) in
  149.            the text are exclusive of the built in \0F style attribute
  150.            codes! Do not mix, use only one.
  151.  
  152. 14.    Changed values of extended INT16 (kbd) functions so won't
  153.            interfere with PROKEY. Prokey will now coexist with
  154.            Extended Batch Language as long as the following patch
  155.            is applied to Prokey. The following text describes the
  156.            necessary changes.
  157.  
  158.  
  159.  
  160. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  161. PROKEY PATCH for versions 2.12 or 2.13 of PROKEY.
  162. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  163.  
  164. IF YOU ARE USING PROKEY *BEFORE* VERSION 3.0, it must be patched to
  165. work with Extended Batch Language. Prokey verion 3.0 and higher DO NOT
  166. need patching and will co-exist with EBL without modification.
  167.  
  168. Early versions of Prokey were written without regard for allowing
  169. other software to access the keyboard interrupt chain (INT16).    EBL
  170. uses it for the stack, and Prokey uses it to simulate keystrokes.  The
  171. following patch will trick Prokey into thinking that no other software
  172. is using the interrupt chain.  As always, keep a copy of the original
  173. before patching.  If you don't understand how to use Debug, find a
  174. friend (maybe someone at your local PC Club) who does.
  175.  
  176. <<<For PROKEY Version 2.12>>>        <<<For PROKEY Version 2.13>>>
  177.  
  178. A>RENAME PROKEY.EXE PROKEY.E        A>RENAME PROKEY.EXE PROKEY.E
  179. A>DEBUG PROKEY.E            A>DEBUG PROKEY.E
  180. -E 2A60                 -E 2DC0
  181. xxxx:2A60  5A.26            xxxx:2DC0  5A.26
  182. -W                    -W
  183. Writing 3280 bytes            Writing 3600 bytes
  184. -q                    -q
  185. A>RENAME PROKEY.E PROKEY.EXE        A>RENAME PROKEY.E PROKEY.EXE
  186. A>                    A>
  187.  
  188. PLEASE NOTE:  You must also use EBL version 2.01 or better.  Also,
  189.   initially as your system starts up, you MUST have EBL loaded FIRST and
  190.   Prokey loaded SECOND in your AUTOEXEC.BAT.  The following is OK:
  191.  
  192.      BAT * 512
  193.      PROKEY /I
  194.  
  195. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  196. PROGRAM CORRECTIONS/CHANGES (for version 2.02 and 2.03 of EBL)
  197. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  198.  
  199. 1. A bug was found in the interface between EBL and DOS. When
  200.    EBL transfers control back to DOS, it also passes any
  201.    variables that have been modified (%0 to %9). The
  202.    problem found with this interface is seen only on
  203.    certain configurations of systems. The symptoms seen
  204.    in the system are completely unrelated to EBL and may
  205.    even show up as random errors with OTHER programs!
  206.    If you suspect problems with another program, you may wish
  207.    to switch to this new 2.03 version of EBL which removes this
  208.    rare and random problem with DOS.
  209.  
  210. 2. Because of problems with INT25 in DOS (disk read) which will
  211.    not work in some networks and when the DOS 'ASSIGN'
  212.    command is used, there is now a way to avoid this
  213.    interrupt. This interrupt is only used in the STATEOF
  214.    command. The new format for this command is:
  215.  
  216.    STATEOF [filename] [drive.list]
  217.  
  218.    The [drive.list] option is new. This token is a list of
  219.    diskette drive letters which are to be searched for the
  220.    specified [filename]. For example, a [drive.list] of
  221.    ACD will search disk drives A:, C:, and D: in that order.
  222.    If a diskette is not in drive A:, DOS will request that
  223.    the user insert one and say "Abort, Retry, Ignore".
  224.  
  225.    That is, only the drive letters listed in [drive.list]
  226.    will be searched and ALL MUST BE INSERTED AND READY.
  227.  
  228.    If the [drive.list] option is not used, the old method
  229.    of searching drives A:, B:, C:, and D: will be used and
  230.    if a diskette is not inserted or ready, it will be
  231.    ignored. Do not omit this option if you are using the
  232.    STATEOF command with the DOS 'ASSIGN' statement or in a
  233.    network environment.
  234.  
  235.    All errors and return codes for the STATEOF command are
  236.    the same. Note that now the STATEOF command can also
  237.    search expanded drive lettering (E:, F:, etc...) by using
  238.    the [drive.list] option with these respective letters.
  239.  
  240. 3. The new version of DOS 3.0 is also supported with this and
  241.    all future levels of EBL (ver 2.02 and higher). Please
  242.    note that this early version of EBL does not support
  243.    nested batch files under DOS 3.0 as it is in 2.0. In
  244.    other words, a second level of command processor cannot
  245.    be loaded to run another (nested) level of batch files.
  246.    I am currently looking at ways to fix this limitation
  247.    within DOS 3.0 and will notify everyone when I have a
  248.    version which allows nesting under DOS 3.0.
  249.  
  250. 4. The version 2.03 of EBL contains all the changes that were in effect
  251.    for earlier versions with one exception.  The keystrokes that are
  252.    emitted during a stacking operation are now much more complete.
  253.    Specifically, the scan codes for all ASCII characters are included
  254.    with the keystroke.    This change was made because some programs were
  255.    found to be looking for specific scan code values from the IBM-PC
  256.    instead of true ASCII values.
  257.  
  258.    The effect of this change is to allow STACK and BEGSTACK statements to
  259.    be used with a wider range of programs.  Multi-mate is an example of a
  260.    program that will now work properly with these EBL statements.  It is
  261.    expected that there may be other programs which will now work with the
  262.    keyboard stack within EBL.
  263.  
  264.  
  265. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  266. GENERAL INFORMATION .........
  267. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  268.  
  269. A bug in DOS version 2.0 and 2.1 has been identified which can cause
  270. problems if you try to use the variables %0 to %9 in an AUTOEXEC.BAT
  271.  
  272. The following AUTOEXEC.BAT file will give bad results or bomb:
  273.   BAT * 512
  274.   BAT %1 = ABC
  275.   REM ABC CHARACTERS COME OUT LIKE %1
  276.  
  277. By restarting the file by hand, there won't be a problem. As a fix, you
  278. can have EBL restart it automatically by doing the following:
  279.   BAT * 512
  280.   BAT IF %Q = K STACK AUTOEXEC | STACK | EXIT
  281.   BAT STACK.PURGE
  282.   BAT %1 = ABC
  283.   REM ABC CHARACTERS COME OUT LIKE %1
  284.  
  285. It turns out that DOS version 2 supplies invalid pointers to EBL for the
  286. %0-%9 variables only during an AUTOEXEC. The locations DOS supplies
  287. get overwritten by DOS during it's execution. In some systems, it will
  288. hang. Hopefully, next versions of DOS won't have this problem.
  289.